home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / standard / imakebackground.z / imakebackground
Encoding:
Text File  |  1998-10-20  |  5.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. iiiimmmmaaaakkkkeeeebbbbaaaacccckkkkggggrrrroooouuuunnnndddd((((3333GGGG))))                                        iiiimmmmaaaakkkkeeeebbbbaaaacccckkkkggggrrrroooouuuunnnndddd((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      iiiimmmmaaaakkkkeeeebbbbaaaacccckkkkggggrrrroooouuuunnnndddd - registers the screen background process
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd iiiimmmmaaaakkkkeeeebbbbaaaacccckkkkggggrrrroooouuuunnnndddd(((())))
  13.  
  14. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  15.      _n_o_n_e
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      iiiimmmmaaaakkkkeeeebbbbaaaacccckkkkggggrrrroooouuuunnnndddd registers a process that maintains the screen background.
  19.      Call it before wwwwiiiinnnnooooppppeeeennnn.  The process should redraw the screen background
  20.      each time it receives a REDRAW event.
  21.  
  22.      There is only one background so only one iiiimmmmaaaakkkkeeeebbbbaaaacccckkkkggggrrrroooouuuunnnndddd process can run
  23.      at a time. Any existing iiiimmmmaaaakkkkeeeebbbbaaaacccckkkkggggrrrroooouuuunnnndddd process is killed when a new one
  24.      is started.
  25.  
  26.      Because the X Window System's inability to change the mode (called the
  27.      _v_i_s_u_a_l in xspeak) of a window conflicts with the GL's freedom to change
  28.      modes at any time, iiiimmmmaaaakkkkeeeebbbbaaaacccckkkkggggrrrroooouuuunnnndddd processes cannot paint on the real
  29.      background (called the _r_o_o_t _w_i_n_d_o_w in xspeak).  Instead a new window is
  30.      created with the correct visual. This window is kept at the bottom of the
  31.      stack of windows just above the screen background. This iiiimmmmaaaakkkkeeeebbbbaaaacccckkkkggggrrrroooouuuunnnndddd
  32.      window works better when it is what in xspeak is called an _o_v_e_r_r_i_d_e-
  33.      _r_e_d_i_r_e_c_t window. In simple terms this means the window is not managed by
  34.      the window manager.
  35.  
  36.      A window that is managed is likely to be given borders by the window
  37.      manager.  Currently only _4_D_w_m(_1_X) and _m_w_m(_1_X) understand the request to
  38.      turn off the borders. Also the window manager will post the usual window
  39.      menu for a managed window. You cannot access the _r_o_o_t _m_e_n_u.  A managed
  40.      window is useful, however, when the iiiimmmmaaaakkkkeeeebbbbaaaacccckkkkggggrrrroooouuuunnnndddd process is running in
  41.      color map mode (see _c_m_o_d_e(_3_G)). The window manager is the only process
  42.      that can install the GL color map according to its own color map
  43.      management policies so that the window is displayed correctly at the
  44.      expected times.
  45.  
  46.      Because of this dichotomy, there is an X resource that controls whether
  47.      or not the iiiimmmmaaaakkkkeeeebbbbaaaacccckkkkggggrrrroooouuuunnnndddd window is managed.  The full resource class is
  48.  
  49.           _N_a_m_e.GL.GLBackground.Manage
  50.  
  51.      _N_a_m_e is the name of the window taken from the argument to winopen The
  52.      resource can have the values _t_r_u_e or _f_a_l_s_e. The default is _f_a_l_s_e. In
  53.      other words if the resource isn't specified the iiiimmmmaaaakkkkeeeebbbbaaaacccckkkkggggrrrroooouuuunnnndddd window is
  54.      not managed. We recommend using managed windows for _c_m_o_d_e(_3_g) processes
  55.      and non-managed windows for _R_G_B_m_o_d_e(_3_g) processes. For example the
  56.      following entries in the X resource database
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiimmmmaaaakkkkeeeebbbbaaaacccckkkkggggrrrroooouuuunnnndddd((((3333GGGG))))                                        iiiimmmmaaaakkkkeeeebbbbaaaacccckkkkggggrrrroooouuuunnnndddd((((3333GGGG))))
  71.  
  72.  
  73.  
  74.           *GLBackground.Manage: false
  75.           texback*GLBackground.Manage: true
  76.  
  77.      cause background windows to be unmanaged except for a background program
  78.      called _t_e_x_b_a_c_k which is known to be a _c_m_o_d_e(_3_g) program.
  79.  
  80. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  81.      winopen
  82.  
  83. NNNNOOOOTTTTEEEE
  84.      This routine is available only in immediate mode.
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.